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About This Book 



This book is a directory of the interfaces provided by the NetView™ program for 
use by customers in writing NetView applications. 

You should read this document if you are: 

• An application programmer or systems programmer who writes programs that 
will invoke the services or functions provided by the NetView program 

• A systems programmer who may wish to utilize user exits, or other interfaces, 
provided by the NetView program to allow the customer to extend or modify the 
NetView program. 

This book is a directory to other documents, or sections of documents, that contain 
the detailed descriptions of programming interfaces. It identifies and specifies lim- 
itations on the use of certain "product sensitive" interfaces, which are dependent 
on the detailed design and implementation of the NetView program. In addition, 
this publication specifies data sets that are created by the NetView program and 
are intended to be accessed by customer programs. It also specifies which macros 
and control blocks distributed with the product are intended to be used as, or as 
part of, a programming interface. 

This book provides a directory of all programming interfaces provided by the 
NetView program for use by customers. No information other than that identified in 
this directory should be construed as defining a programming interface. 
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Chapter 1. Programming Interfaces for Customers 



Programming interfaces for customers of the NetView™ program allow customer- 
written programs to request or receive functions or services of the NetView 
program. This chapter lists the publications that describe NetView programming 
interfaces. The specific sections that describe NetView programming interfaces 
are identified within the publications themselves. 

NetView Customization: Writing Command Lists (SC31-6015) 

This book describes how to write command lists for the NetView program. 

NetView Customization: Using PL/I and C (SC31-6037) 

This book describes how to write programs in PL/I and C for the NetView program. 
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Chapter 2. Product-Sensitive Programming Interfaces 



This chapter lists the publications that describe "product sensitive" interfaces pro- 
vided by the NetView program. The specific sections that describe "product sensi- 
tive" interfaces are identified within the publications themselves. Installation exits 
and other "product sensitive" interfaces are provided to allow the customer to 
perform tasks such as product tailoring, monitoring, modification, or diagnosis. 
These tasks are dependent on the detailed design or implementation of the 
NetView program. Because of their dependencies on detailed design and imple- 
mentation, it is to be expected that programs written to such interfaces may need 
to be changed in order to run with new NetView releases or versions, or as a result 
of maintenance. Such interfaces should be used only for their. specialized pur- 
poses. 

NetView Customization: Using Assembler (SC31-6078) 

This book describes the ways system programmers can tailor the NetView program 
to satisfy unique requirements or operating procedures. It provides instructions for 
designing, writing, and installing user-written programs in Assembler language. 
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Chapter 3. Data Sets 



External Logs 



This chapter lists those data sets created by the NetView program that are 
intended to be accessed by customer programs. 



The NetView program allows customers to write hardware monitor and session 
monitor data to an external log. The record formats for the hardware monitor and 
session monitor external logs are illustrated in: 

NetView Administration Reference (SC31-6014) 
• Appendix A. External Log Record Formats and Event Qualifiers 

- Hardware Monitor External Log Record 

— Session Monitor External Log Record 



Network Asset Management Data 



The NetView program displays vital product data, via the VPDCMD command, and 
allows customers to write command lists to collect and manage network asset 
management (NAM) data. Information about this is described in: 

NetView Administration Reference (SC31-6014) 

• Appendix B. Network Asset Management Vital Product Data Descriptions and 
Sample Record Formats 

- Vital product data returned from the VPDCMD command 

- Record formats used by sample NAM command lists 
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Chapter 4. Macros and Control Blocks 



This chapter lists the macros and control blocks that are intended to be used as, or 
as part of, a customer programming interface. 

Control blocks for PL/I and C are described in detail in Appendixes A and C of 
NetView Customization: Using PL/I and C (SC31-6037). 

Assembler-language control blocks and macros are described in detail in Chapters 
7 and 8 of NetView Customization: Using Assembler (SC31-6078). 

Distribution Library Name - NCCFMAC MACLIB 
• PL/I control blocks 



DSIPLI 


Main Include File 


DSIPCONS 


Constants 


DSIPHLB 


Mapping of DSIHLB 


DSIPORIG 


Mapping of Origin Block 


DSIPHLLS 


Definitions for Service Routines 


DSIPCNM 


Return Codes 


C control blocks 


DSIC 


Main Include File 


DSICCONS 


Constants 


DSICVARC 


Varying Length Character Strings 


DSICHLB 


Mapping of DSIHLB 


DSICORIG 


Mapping of Origin Block 


DSICCALL 


Definitions for Service Routines 


DSICCNM 


Return Codes 


Assembler-language control blocks 


BUFHDR 


Buffer Header 


DSiCBH 


Control Block Header 


DSICPMSU 


Control Point Management Services RU 


DSICWB 


Command Work Block 


DSIDSRB 


Data Services Request Block 


DSIIFR 


Internal Function Request 


DSILOGDS 


NetView Log DSECT 


DSIMVT 


Main Vector Table 


DSIPDB 


Parse Descriptor Block 


DSISCE 


System Command Entry 


DSISCT 


System Command Table 


DSISVL 


Service Routine Vector List 


DSISWB 


Service Work Block 


DSITIB 


Task Information Block 


DSITVB 


Task Vector Block 


DSIUSE 


User Exit Parameter List 


Assembler-language macros 


DSICBS 


Control Block Services 


DSICES 


Command Entry Services 


DSIDATIM 


Date and Time 


DSIDEL 


Delete User-Defined Module 
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DSIDKS Disk Services 

DSIFIND Find Long Running Command Storage 

DSIFRE Free Storage 

DSIGET Get Storage 

DSIKVS Keyword/Value Services 

DSILCS Obtain/Release Control Blocks 

DSILOD Load User-Defined Module 

DSIMBS Message Buffer Services 

DSIMDS Message Definition Services 

DSIMQS Message Queuing Services 

DSIOIS Operator Identification Services 

DSIPAS Parameter/Alias Service 

DSIPOP Remove Long Running Command 

DSIPOS ECB Post Services 

DSIPRS Parsing Services 

DSIPSS Presentation Services 

DSIPUSH Queue Long Running Command 

DSIRDS Resource Definition Services 

DSIRXEBS Get an EVALBLOK 

DSISSS Search Span Name Table Services 

DSiWAT ECB Wait Services 

DSIWCS Write Console Services 

DSIWLS Write Log Services 

DSIZCSMS CNM Data Services 

DSIZVSMS VSAM Data Services 

Note: Some programming interfaces include the use or specification of certain 
fields within an otherwise internal control block. You should use only those fields 
that are documented as part of the programming interface. For detailed informa- 
tion on the use and restrictions of the macros and control blocks listed in this 
section, please refer to NetView Customization: Using PUI and C and NetView 
Customization: Using Assembler. 
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